LiveCode 8.1.5 Release Notes 7/10/17 
LiveCode 6.1.5 Release Notes 


e Overview 
e Known issues 
e Platform support 


0 Windows 
o Linux 

o Mac 

o0 iOS 

0 Android 
°0 HTML5 


o Installation 

o Uninstallation 

o Reporting installer issues 

0 Activating LiveCode Indy or Business edition 

© Command-line installation 

© Command-line uninstallation 

© Command-line activation for LiveCode Indy or Business edition 


e Engine changes 


o Send script form of send command (8.1.5-rc-3) 

o Add param that suppresses success message when building standalone (8.1.5-rc-1) 
o Type should work with accented characters (8.1.5-rc-1) 

0 revAvailableHandlers and revAvailableVariables now in all engines (8.1.5-rc-1) 

o Specific engine bug fixes (8.1.5-rc-3) 

o Specific engine bug fixes (8.1.5-rc-2) 

o Specific engine bug fixes (8.1.5-rc-1) 


e IDE changes 


o Create script only stack behavior (8.1.5-rc-1) 
o Drag and drop stackfiles (8.1.5-rc-1) 

o Specific IDE bug fixes (8.1.5-rc-3) 

o Specific IDE bug fixes (8.1.5-rc-1) 


e LiveCode extension changes 
o Specific extension bug fixes (8.1.5-rc-1) 


e Previous release notes 


Overview 





LiveCode 8.1 provides important improvements for delivering high-quality cross-platform 
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applications! 


e LiveCode Indy and Business editions now come with the tsNet external, which supercharges 
LiveCode's Internet features and performance. LiveCode 8.1 also introduces mergHealthkKit, 
for accessing activity, sport and health data on iOS devices. 


e The standalone builder now has a greatly-improved user experience for including externals, 
script libraries and LiveCode Builder extensions in your cross-platform application. Usually, 
it'll now do the right thing automatically, but you can still select the specific inclusions you 
need. 


e The IDE has lots of other upgrades, too: a keyboard-navigable Project Browser that 
highlights any scripts that failed to compile, an improved dictionary user interface, and 
access to the message box just by starting to type. 


e The player control can be used in Windows application without any need for users to install 
any additional libraries or dependencies, thanks to a brand new player implementation 
based on DirectShow. For most apps, it should now be unnecessary to install or use 
QuickTime at all. 


e The LiveCode Builder programming language has had some enhancements as part of the 
Infinite LiveCode project. Variables now get initialised by default, unsafe blocks and 
handlers can be used to flag sections of code that do dangerous things, and you can even 
include raw bytecode if necessary. 


Known issues 





e The installer will currently fail if you run it from a network share on Windows. Please copy the 
installer to a local disk before launching on this platform. 


e The browser widget does not work on 32-bit Linux. 


e 64-bit standalones for Mac OS X do not have support for audio recording or the 
revVideoGrabber external. 
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The engine supports a variety of operating systems and versions. This section describes the 
platforms that we ensure the engine runs on without issue (although in some cases with reduced 
functionality). 


Windows 
LiveCode supports the following versions of Windows: 


e Windows XP SP2 and above 
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e Windows Server 2003 

e Windows Vista SP1 and above (both 32-bit and 64-bit) 
e Windows 7 (both 32-bit and 64-bit) 

e Windows Server 2008 

e Windows 8.x (Desktop) 

e Windows 10 


Note: On 64-bit Windows installations, LiveCode runs as a 32-bit application through the WoW 
layer. 


Linux 


LiveCode supports the following Linux distributions, on 32-bit or 64-bit Intel/AMD or compatible 
processors: 


e Ubuntu 14.04 and 16.04 

e Fedora 23 & 24 

e Debian 7 (Wheezy) and 8 (Jessie) [Server] 
e CentOS 7 [server] 


LiveCode may also run on Linux installations which meet the following requirements: 
e Required dependencies for core functionality: 


o glibc 2.13 or later 
o glib 2.0 or later 


e Optional requirements for GUI functionality: 


0 GTK/GDK 2.24 or later 

0 Pango with Xft support 

°o esd (optional, needed for audio output) 

o mplayer (optional, needed for media player functionality) 

°o Icms (optional, required for color profile Support in images) 
°o gksu (optional, required for privilege elevation support) 


Note: If the optional requirements are not present then LiveCode will still run but the specified 
features will be disabled. 


Note: The requirements for GUI functionality are also required by Firefox and Chrome, so if your 
Linux distribution runs one of those, it will run LiveCode. 


Note: It may be possible to compile and run LiveCode Community for Linux on other 
architectures but this is not officially supported. 


Mac 


The Mac engine supports: 


e 10.6.x (Snow Leopard) on Intel 
e 10.7.x (Lion) on Intel 
e 10.8.x (Mountain Lion) on Intel 
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e 10.9.x (Mavericks) on Intel 
e 10.10.x (Yosemite) on Intel 
e 10.11.x (El Capitan) on Intel 
e 10.12.x (Sierra) on Intel 


iOS 
IOS deployment is possible when running LiveCode IDE on a Mac, and provided Xcode Is installed 
and has been set in LiveCode Preferences (in the Mobile Support pane). 


Currently, the supported versions of Xcode are: 


e Xcode 4.6 on MacOS X 10.7 

e Xcode 5.1 on MacOS X 10.8 

e Xcode 6.2 on MacOS X 10.9 

e Xcode 6.2 and 7.2 on Mac OS X 10.10 
e Xcode 8.2 on MacOS X 10.11 

e Xcode 8.3 on MacOS 10.12 


It is also possible to set other versions of Xcode, to allow testing on a wider range of iOS 
Simulators. For instance, on OS X 10.10 (Yosemite), you can add Xcode 5.1 in the Mobile Support 
preferences, to let you test your stack on the /OS Simulator 7.1. 


We currently support deployment for the following versions of iOS: 


e 6.1 [simulator] 
e 7.1 [simulator] 
e 8.2 [simulator] 
e 9.2 

e 10.2 

e 10.3 


Android 


LiveCode allows you to save your stack as an Android application, and also to deploy it on an 
Android device or simulator from the IDE. 


Android deployment is possible from Windows, Linux and Mac OSX. 


The Android engine supports devices using ARMv6, ARMv7 or ARMVv8 processors. It will run on the 
following versions of Android: 


e 2.3.3-2.3.7 (Gingerbread) 
e 4.0 (Ice Cream Sandwich) 
e 4.1-4.3 Jelly Bean) 

e 4.4 (KitKat) 

e 5.0-5.1 (Lollipop) 

e 6.0 (Marshmallow) 

e 7.0 (Nougat) 


To enable deployment to Android devices, you need to download the Android SDK, and then use 
the ‘Android SDK Manager to install: 
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e the latest "Android SDK Tools" 
e the latest "Android SDK Platform Tools" 


You also need to install the Java Development Kit (JDK). On Linux, this usually packaged as 
"openjdk". LiveCode requires JDK version 1.6 or later. 


Once you have set the path of your Android SDK in the "Mobile Support" section of the LiveCode 
IDE's preferences, you can deploy your stack to Android devices. 


Some users have reported successful Android Watch deployment, but it is not officially supported. 


HTMLS5 


LiveCode applications can be deployed to run in a web browser, by running the LiveCode engine in 
JavaScript and using modern HTMLS5 JavaScript APIs. 


HTML5 deployment does not require any additional development tools to be installed. 


LiveCode HTML5 standalone applications are currently supported for running in recent versions of 
Mozilla Firefox, Google Chrome or Safari. For more information, please see the "HTML5 
Deployment" guide in the LiveCode IDE. 


Setup 





Installation 


Each version of LiveCode installs can be installed to its own, separate folder. This allow multiple 
versions of LiveCode to be installed side-by-side. On Windows (and Linux), each version of 
LiveCode has its own Start Menu (or application menu) entry. On Mac OS X, each version has its 
own app bundle. 


On Mac OS xX, install LiveCode by mounting the .dmg file and dragging the app bundle to the 
Applications folder (or any other suitable location). 


For Windows and Linux, the default installation locations when installing for "All Users" are: 


Platform Path 
Windows <x86 program files folder>/RunRev/LiveCode <version> 


Linux /opt/livecode/livecode-<version> 


The installations when installing for "This User" are: 


Platform Path 

incu <user roaming app data folder>/RunRev/Components/LiveCode 
<version> 

Linux ~/.runrev/components/livecode-<version> 
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Note: If installing for "All Users" on Linux, either the gksu tool must be available, or you must 
manually run the LiveCode installer executable as root (e.g. using sudo or su). 


Uninstallation 


On Windows, the installer hooks into the standard Windows uninstall mechanism. This is accessible 
from the "Add or Remove Programs" applet in the windows Control Panel. 


On Mac OS xX, drag the app bundle to the Trash. 


On Linux, LiveCode can be removed using the setup.x86 or setup.x86 64 program located in 
LiveCode's installation directory. 


Reporting installer issues 


If you find that the installer fails to work for you then please report it using the LiveCode Quality 
Control Centre or by emailing support@livecode.com. 


Please include the following information in your report: 


e Your platform and operating system version 

e The location of your home or user folder 

e The type of user account you are using (guest, restricted, admin etc.) 
e The installer log file. 


The installer log file can be located as follows: 


Platform Path 
Windows 2000/XP <documents and settings folder>/<user>/Local Settings/ 
Windows Vista/7 <users folder>/<user>/AppData/Local/RunRev/Logs 


Linux <home>/.runrev/logs 


Activating LiveCode Indy or Business edition 


The licensing system ties your product licenses to a customer account system, meaning that you 
no longer have to worry about finding a license key after installing a new copy of LiveCode. 
Instead, you simply have to enter your email address and password that has been registered with 
our customer account system and your license key will be retrieved automatically. 


Alternatively it is possible to activate the product via the use of a specially encrypted license file. 
These will be available for download from the customer center after logging into your account. This 
method will allow the product to be installed on machines that do not have access to the internet. 


Command-line installation 


It is possible to invoke the installer from the command-line on Linux and Windows. When doing 
command-line installation, no GUI will be displayed. The installation process is controlled by 
arguments passed to the installer. 
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Run the installer using a command in the form: 


<installer> install noui [OPTION ...] 


where <installer> should be replaced with the path of the installer executable or app (inside 
the DMG) that has been downloaded. The result of the installation operation will be written to the 
console. 


The installer understands any of the following OPTIONs: 


Option Description 
Install the IDE for "All Users". If not specified, LiveCode will be installed 
-allusers 
for the current user only. 
deshenanatieeteun Place a shortcut on the Desktop (Windows-only) 
-startmenu Place shortcuts in the Start Menu (Windows-only) 
-location The folder to install into. If not specified, the LOCATION defaults to those 
LOCATION described in the "Installation" section above. 
“og LOGFILE The file to which to log installation actions. If not specified, no log is 
generated. 


Note: the command-line installer does not do any authentication. When installing for "All Users", 
you will need to run the installer command as an administrator. 


As the installer is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <installer> install noui [OPTION ...] 


Command-line uninstallation 


It is possible to uninstall LiveCode from the command-line on Windows and Linux. When doing 
command-line uninstallation, no GUI will be displayed. 


Run the uninstaller using a command of the form: 
<uninstaller> uninstall noui 


Where is .setup.exe on Windows, and .setup.x86 on Linux. This executable, for both of the 
platforms, is located in the folder where LiveCode is installed. 


The result of the uninstallation operation will be written to the console. 


Note: the command-line uninstaller does not do any authentication. When removing a version of 
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LiveCode installed for "All Users", you will need to run the uninstaller command as an 
administrator. 


Command-line activation for LiveCode Indy or Business edition 


It is possible to activate an installation of LiveCode for all users by using the command-line. When 
performing command-line activation, no GUI is displayed. Activation is controlled by passing 
command-line arguments to LiveCode. 


Activate LiveCode using a command of the form: 


<livecode> activate -file LICENSEFILE -passphrase SECRET 


where <livecode> should be replaced with the path to the LiveCode executable or app that has 
been previously installed. 


This loads license information from the manual activation file LICENSEFILE, decrypts it using the 


given SECRET passphrase, and installs a license file for all users of the computer. Manual 
activation files can be downloaded from the My Products page in the LiveCode account 
management site. 


It is also possible to deactivate LiveCode with: 

<lLivecode> deactivate 

Since LiveCode is actually a GUI application, it needs to be run slightly differently from other 
command-line programs. 


On Windows, the command is: 


Start /wait <livecode> activate -file LICENSE -passphrase SECRET 
Start /wait <livecode> deactivate 


On Mac OS xX, you need to do: 


<Livecode>/Contents/MacOS/LiveCode activate -file LICENSE -passphrase SECRET 
<Livecode>/Contents/MacOS/LiveCode deactivate 
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Send script form of send command (8.1.5-rc-3) 
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The syntax 
send script <script> to <obj> 


has been added to allowa chunk of script to be executed in the context of an object without any 
attempted evaluation of parameters that occurs with the original form of the send command. 


For example, suppose there is a stack named "Stack" with script 


on doAnswer pParam 
answer pParam 
end doAnswer 


function myName 
return the short name of me 
end myName 


and a button on the stack named "Button" with script 


on mouseUp 

send "doAnswer myName()" to this stack 

send script "doAnswer myName()" to this stack 
end mouseUp 


function myName 
return the short name of me 
end myName 


clicking the button would result in an answer dialog first saying "Button" as the myName function 
would be evaluated in the button context, then "Stack" as using the script form would result in 
the myName function being evaluated in the stack context. 


Add param that suppresses success message when building 
standalone (8.1.5-rc-1) 


By default revSaveAsStandalone displays the message 


answer information "Standalone application saved successfully." when it is done. 


You can turn off this message by setting the test environment to true but doing so suppresses all 
error messages and other feedback as well. 


lam calling revSaveAsStandalone from my own scripts multiple times and want feedback and 
error reporting but not the success message. Adding an additional parameter to 
revSaveAsStandaLone that suppress the success message would allow this. 
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Type should work with accented characters (8.1.5-rc-1) 


The type command now handles Unicode characters in a manner consistent with normal 
keyboard entry. If a Unicode character is typed and it has a native mapping, then it is propagated 
as a keypress with the keycode being the code of the character. If it has no native mapping, it is 
propagated with keycode equal to the Unicode codepoint with bit 22 set to 1. In either case the 
String value of the keypress is the Unicode codepoint. 


revAvailableHandlers and revAvailableVariables now in all 
engines (8.1.5-rc-1 


The 'the [effective] revAvailableHandlers' and 'the revAvailableVariables' properties are now 
available in both the IDE and Standalone engines. 


Note: These properties are currently undocumented, and reserved for IDE related uses. You are 
free to use in your own code, but their semantics could change in any release. 


Specific engine bug fixes (8.1.5-rc-3) 


19983 Ensure put URL tUrl does not return empty when tUrl is invalid 


Specific engine bug fixes (8.1.5-rc-2) 


19861 Fix crash on startup on Linux when RGBA is not supported 
19869 The effective revAvailableHandlers only includes private handlers of the target 


Specific engine bug fixes (8.1.5-rc-1) 


Ensure that the initial orientation is not upside down on Android when "portrait" is 


11146 


13482 
14266 
15997 
16758 
17540 
17850 
17969 
18407 
18670 
18689 
18939 
19069 
19275 
Is27 
19361 


selected. 

Document optional catch clause in try control structure 

Fixing crash when using "import eps" 

Implement player 'mirrored' property on Windows 

Fixed bug causing crash when setting 65535 points to a graphic 

Fix crash on Mac when displaying IDE usage message 

Fix inconsistent browser callbacks in browser widget on iOS 

Fixed bug preventing correct rendering of ovals when creating them 
Fixed bug preventing the use of "set the visible of line <> of field <>" 
Fixed bug preventing all table names being retrieved in MySQL db's 
Fixed bug causing erronous cursor movement when using arrow keys 
Fix player image incorrectly scaled in edit mode 

Fixed bug causing crash when building standalone 

Fix Android crash when a Stack is deleted shortly after switching to another stack. 
Fix incorrect browser widget location when stack has a menu on OSX 
Added missing parantheses for revisSpeaking() 
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19509 
19520 
19528 
19529 
19535 
19336 


19541 


19581 
Ig523 
19613 
19615 
19620 
19630 
19633 
19637 
19646 
19649 
19650 
19666 
19668 
19672 
19687 
19688 
19693 
19699 
19742 
19743 
Ig 7D 
19796 
19797 
19808 
19826 
19830 
19637 
19841 
19843 
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Make sure Android Studio works with LiveCode 

Make sure mirrored property works correctly on Mac 

Allow 'relaunch' message to be in behavior of main stack 

Fix incorrect snapshot area when primary screen origin is not 0,0 

Fixed error causing blue rectangle to be drawn incorrectly when doing CMD-A on text 
Fixed bug preventing users from selecting text of length 65535 


Fix clipboard ownership checks on windows causing private clipboard data to be 
cleared 


Do not send pushNotificationReceived/localNotificationReceived message twice 
Type should work with accented characters 

Make sure setting the htmlText of a field does not remove superscripts 

Fixed references in the quit dictionary entry 

Update cursor when entering window on windows 

Make sure setting the iphoneSetAudioCategory is respected 

Modify tsNet libUrl wrapper to treat HTTP status codes > 400 as errors 

Errors building iOS standalones should only be reported once 

Make sure using mobile camera does not change the value of mobileLockldleTimer 
Correctly parse multiple bytes escaped as hex in the format function 

Fix tsNet proxy support on Linux, OS X and Android 

Make sure you can set more than one javascriptHandlers on CEF Browser 
Fixed bug causing crash when using custom undo 

Prevent crash on throwing certain errors 

Preserve error from chunk-of-code send form 

Ensure ‘put the objProp' causes a parse error 

Ensure closed players use no system resources 

Fixed bug that overrides previous matches in matchText 

Fix crash when deleting an object when a socket has a reference to a deleted object 
Fix crash when checking a watched variable on a deleted object 

Fix various error inconsistencies in selected object cut and delete 

Fix crash when SSL is unavailable on HTML5 

Implement put before msg in HTML5 

Notify property listener when text of control is changed via put cmd 

Fix iOS simulator deployment with Xcode 8.3.3 

Fixed regression introduced by bugfix-19535 

Fix crash due to deletion of object with pending message 

Message box does not find handlers in behaviors 

revAvailableHandlers and revAvailableVariables now in all engines 
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Create script only stack behavior (8.1.5-rc-1) 


The menu for assigning a behavior to a control has two additional options: 


11 


LiveCode 8.1.5 Release Notes 7/10/17 


e Create behavior from new script only stack 

e Create behavior using control script and script only stack Either option will prompt you for a 
Stack name and a location for the script only stack. The new stack will be saved, assigned 
as the behavior of the control, and then added to the stackfiles property of control's stack. 


Drag and drop stackfiles (8.1.5-rc-1) 


You can now drag and drop stack files onto the stackFiles field in the PI. 


Specific IDE bug fixes (8.1.5-rc-3) 


19967 
19985 


Fix second parameter evaluation for script in message box 
Remove errant group from the script editor 


Specific IDE bug fixes (8.1.5-rc-1) 


18201 
18598 
18685 


18878 


19264 
19480 
19547 
19585 
19589 
19627 
19629 


19838 
5787 


Make sure rulers can be hidden 

Prevent error on backspace in empty script editor 

Remember the last position of menubar on Windows and Linux 

Setting stackFiles in Pl causes an error if you "cancel" the file dialog or select multiple 
files 

Ensure LCB errors display reasonably in script editor 

Ensure message box execution succeeds first time if no compile error 

Fixed bug preventing users from finding | and - in the script editor 

Improve rendering of Interactive Tutorial on Windows when screenPixelScale > 1 
Fix ‘put globalVar' in msg box 

Clear deleted objects from project browser correctly 

Check for changes in filename when getting object row in project browser 

Add explicit 'select object’ steps to the Interactive Tutorials to ensure the correct 
object is always selected. 

Drag and drop stackfiles 
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Specific extension bug fixes (8.1.5-rc-1) 


16241 


Runtime error when changing itemCount by more than one 
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